home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 326-350 / disk_326 / dispmod / docs / ctrl.doc < prev    next >
Text File  |  1992-05-06  |  2KB  |  46 lines
  1.  
  2. NAME:        CTRL
  3.  
  4. SYNTAX:    CTRL <portname>
  5.  
  6. DESCRIPTION:
  7.  
  8.   CTRL tells the display module to send all further messages (except
  9.   'normal' keyboard input) to the port named.  These messages include
  10.   the messages sent when any function key or the the HELP key is
  11.   pressed.
  12.  
  13.   It is used for transferring control to another script or program.
  14.   For example, you could use a script designed to emulate a terminal
  15.   program and after a connection is made, control could be transferred
  16.   to a script that ran a game or manipulated a database.
  17.  
  18.   If you do not issue a CTRL command, DispMod will use the default
  19.   CTRL port; 'ROBBS_ctrl'.
  20.  
  21.   It is important to note the difference between CTRL and CONNECT. CTRL
  22.   specifies where function key and HELP keypresses are sent, since they
  23.   are usually sent to a 'controlling program', as opposed to a program
  24.   that expects ASCII characters. CONNECT is for sending characters (with
  25.   a command) to a program that understands what to do with them.
  26.  
  27.   Note that a program refers to either an ARexx script or an executable
  28.   written in any other language, and that the CTRL and CONNECT ports may
  29.   be the same port.
  30.  
  31. EXAMPLE:
  32.  
  33.     CTRL 'ROBBS_checkers'
  34.  
  35.   After executing this command, the display would send all function
  36.   key and HELP key messages to the port named 'CCS_checkers', which
  37.   might have some idea of how to play a game.  The script programmer
  38.   is responsible for ensuring that the port named actually exists,
  39.   usually after calling the new program that opens a port of the
  40.   appropriate name.
  41.  
  42.   The function keys send a message with the first srgument being FKEY
  43.   The HELP key sends a message with the first argument being HELP
  44.  
  45. SEE ALSO: CONNECT, CTRL, STATUS
  46.